home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / cli / MayFlower.lha / MayFlower / ASR / ASR.doc < prev    next >
Text File  |  1994-05-12  |  27KB  |  596 lines
  1.  
  2.                         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.                            Announce System Requests
  4.  
  5.                         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  6.                                   Alias: ASR
  7.  
  8.                      Copyright © 1991 Stephen D. Childers
  9.  
  10.                     Version Number: 19940301  (1 Mar 1994)
  11.  
  12. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  13.  
  14.    Announce System Requests                                Page i-01
  15.  
  16.                            Table of Contents
  17.                         -----------------------
  18.       Chapters:
  19.  
  20.          Program Author ................................ Page  A-01
  21.          Program Description ........................... Page  A-02
  22.          CLI Usage ..................................... Page  A-03
  23.          CLI Examples .................................. Page  A-04
  24.          Workbench Usage ............................... Page  A-05
  25.          Program Messages and Errors ................... Page  A-06
  26.          How To Make Extra PROJECT Icons................ Page  A-07
  27.          Operational Notes ............................. Page  A-08
  28.          Programmer's Notes ............................ Page  A-09
  29.          Version History................................ Page  A-10
  30.  
  31. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  32.  
  33.    Program Author:                                         Page A-01
  34.  
  35.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  36.    Address:
  37.                                                 --- ---
  38.           Stephen D. Childers                   (o) (o)
  39.           2302 West Vesper Street                  ^
  40.           Blue Springs, Missouri 64015          \_____/
  41.  
  42.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43.        /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  44.       /                                                            \
  45.      /                                                              \
  46.     /      12  Therefore all things whatsoever ye would that men     \
  47.    /   should do to you, do ye even so to them: for this is the law   \
  48.    \   and the prophets.                                              /
  49.     \                                                                /
  50.      \                 The King James Holy Bible - Matthew 7:12     /
  51.       \                                                            /
  52.        \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  53.        //\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\
  54.       /X__XX__XX__XX__XX__XX__XX__XX__XX__XX__XX__XX__XX__XX__XX__X\
  55.      //                                                            \\
  56.     //                                                              \\
  57.     X       23  For the wages of sin is death; but the gift of God   X
  58.     X    is eternal life through Jesus Christ our Lord.              X
  59.     X                                                                X
  60.     \\                The King James Holy Bible - Romans 6:23       //
  61.      \\ __  __  __  __  __  __  __  __  __  __  __  __  __  __  __ //
  62.       \X  XX  XX  XX  XX  XX  XX  XX  XX  XX  XX  XX  XX  XX  XX  X/
  63.        \\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//
  64.        /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  65.       /                                                            \
  66.      /                                                              \
  67.     /       16  For I am not ashamed of the gospel of Christ: for    \
  68.    /     it is the power of God unto salvation to every one that      \
  69.    \     believeth; to the Jew first, and also to the Greek.          /
  70.     \                                                                /
  71.      \                The King James Holy Bible - Romans 1:16       /
  72.       \                                                            /
  73.        \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  74.  
  75. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  76.  
  77.    Program Description:                                    Page A-02
  78.  
  79.    1) The main purpose of this program is to cause an audible noise
  80.       to be made when a System Request (henceforth referenced as SR)
  81.       pops up on the screen. This is useful if you plan to be away,
  82.       but not very far, from your computer system.
  83.  
  84.       This will then allow you to do other things like read and
  85.       study your software books (or snooze) while your Amiga works.
  86.       And should a certain type of SR happen you will then be alerted
  87.       by an audible noise generated by your Amiga.
  88.  
  89.       A good example of a possible SR event could be:
  90.         Your Amiga gets a transient Read/Write error with your Hard Drive
  91.         while compiling hundreds of 'C' source code files... <HORRORS> !!
  92.         (Lattice C by the way)
  93.  
  94.       This is better than having your Amiga idle QUIETLY while it waits
  95.       for you to notice an SR event that needed a decision an HOUR AGO !
  96.  
  97.    2) Can be used from CLI or Workbench. Can be made resident, but the
  98.       only benefit of making it resident is to bypass loading time when
  99.       program is invoked.
  100.  
  101.    3) Process will increase its own priority by 7.
  102.  
  103.    4) The program title "Announce System Requests" will be shortened
  104.       to an acronym and henceforth referenced as "ASR".
  105.  
  106.    5) After ASR is installed it will WAIT in an idle state until
  107.       activated by any program that causes a SR to pop up on the
  108.       screen. After ASR activates it will then cause some type of
  109.       audible noise to be made which will then bring your attention
  110.       back to the computer.
  111.  
  112.       The noise that ASR generates will depend upon the options you
  113.       set. The noise may be generated by the SPEAK DEVICE mode, or by
  114.       the COMMAND LINE mode. These modes are explained in detail
  115.       elsewhere in this document.
  116.  
  117.    6) ASR needs the SPEAK: device mounted for announcing its startup
  118.       and its ending. The SPEAK: device will look for the
  119.       "translator.library" and the "narrator.device".
  120.  
  121.    7) It is alright for you to respond to any SR before the announcement
  122.       ends without disrupting the system, but this will also depend upon
  123.       the type of noise program that you give ASR to launch. ASR may not
  124.       announce all of the SR text if you respond rather quickly to an SR.
  125.  
  126.       It may be possible for the ASR program to miss an announcement
  127.       if more than one SR pops up within moments of each other. The
  128.       text that you hear from SPEAK: may also sound strange.
  129.  
  130.    8) ASR can be used with the "Cancel System Requests" (CSR) program.
  131.       This will allow you to hear any SR as it is automatically canceled.
  132.  
  133.    9) ASR will install itself only once.
  134.  
  135.    10) Invoking ASR with option -i from CLI will cause ASR to completely
  136.        detach from the CLI and run as a background process.
  137.  
  138.        If the background process should fail then it will attempt to
  139.        notify you of that fact with a SR.
  140.  
  141. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  142.  
  143.    CLI Usage:                                              Page A-03
  144.  
  145.       > ASR !|?|-options ["COMMAND LINE string or SPEAK DEVICE options"]
  146.  
  147.    Description of -options:
  148.  
  149.       Option 'G'  (Gadgets text announced)
  150.  
  151.          1) This will cause the text within the SR gadgets to be
  152.             announced. This only works in SPEAK DEVICE mode.
  153.  
  154.          2) The announcement of gadgets will sound something like this:
  155.                   "Positive choice is " + <text of left gadget>
  156.                   "Negative choice is " + <text of right gadget>
  157.  
  158.             All System Requests will have at least one gadget.
  159.  
  160.       Option 'I'  (Install)
  161.  
  162.          1) This installs the ASR code. If used alone (ie "ASR -i")
  163.             it will cause internal SPEAK DEVICE mode and string to be
  164.             used. This option causes ASR to detach from CLI.
  165.             ASR will announce the following when installing:
  166.  
  167.                   "Installing Announce System Requests"
  168.  
  169.       Option 'C'  (COMMAND LINE mode)
  170.  
  171.          1) This may be used in conjunction with the 'I' option and
  172.             this puts ASR into the COMMAND LINE mode.
  173.  
  174.          2) The COMMAND LINE string may be any CLI command that can be
  175.             typed from CLI, though you should use only commands which
  176.             generate some type of audible noise (or musick) for a few
  177.             moments and then quit. This COMMAND LINE string with its
  178.             options must be within quotes.
  179.  
  180.          3) Command must exist along search path or ASR does nothing.
  181.  
  182.          4) You should supply a COMMAND LINE string with this option or
  183.             else the internal SPEAK DEVICE mode becomes the default.
  184.  
  185.       Option 'S'  (SPEAK DEVICE mode)
  186.  
  187.          1) This may be used in conjunction with the 'I' option and this
  188.             puts ASR into the SPEAK DEVICE mode.
  189.  
  190.          2) Using the 'S' option without a SPEAK DEVICE string will cause
  191.             the internal SPEAK: string parameter to be used.
  192.             The internal default SPEAK: string is "opt/m/p80/s170"
  193.  
  194.       Option 'Q'  (Quiet)
  195.  
  196.          1) This will cause the ASR process to keep quiet with reference
  197.             to its process messages. No messages will be displayed.
  198.  
  199.       Option 'R'  (Remove)
  200.  
  201.          1) This will send the remove signal to the ASR process.
  202.  
  203.          2) The ASR process will not remove itself if any SR is pending
  204.             a user's decision.
  205.  
  206.          3) If ASR successfully detects the remove signal it will
  207.             announce the following:
  208.  
  209.                   "Removing Announce System Requests"
  210.  
  211. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  212.  
  213.    CLI Examples:                                           Page A-04
  214.  
  215.    To see for yourself what the program can do then type the following
  216.    examples from CLI.
  217.  
  218.                 (take notice of "quotes" within examples)
  219.    -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
  220.    ; EXAMPLE 1, install COMMAND LINE mode
  221.  
  222.       CLI > ASR -ic "Say -m -p100 -s170 Yo, programmer, Guess what."
  223.  
  224.       CLI > cd OopsDisk:
  225.  
  226.          ; Now cancel the SR before typing next line.
  227.          ; You MUST always remove the OLD announcement before
  228.          ; installing a NEW announcement.
  229.  
  230.       CLI > ASR -r        ; Remove ASR from system.
  231.  
  232.    -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
  233.    ; EXAMPLE 2, install COMMAND LINE mode (general announcement)
  234.  
  235.       CLI > ASR -ic "Say -p65 -s200 System Request."
  236.  
  237.       CLI > cd KickWork:
  238.                           ; Cancel SR before typing next line.
  239.       CLI > ASR -r
  240.  
  241.    -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
  242.    ; EXAMPLE 3, install SPEAK DEVICE mode
  243.  
  244.       CLI > ASR -isg "opt/f/p270/s170"
  245.  
  246.       CLI > cd "Letters ...:"
  247.                           ; Cancel SR before typing next line.
  248.       CLI > ASR -r
  249.  
  250.    -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
  251.    ; EXAMPLE 4, install SPEAK DEVICE mode (with default options)
  252.  
  253.       CLI > ASR -isg
  254.  
  255.       CLI > cd "Lattiss C:"
  256.                           ; Cancel SR before typing next line.
  257.       CLI > ASR -r
  258.  
  259.    -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
  260.    ; EXAMPLE 5, Try the "Beep" program which you should find with this
  261.    ; program package.
  262.  
  263.       CLI > ASR -ic "Beep -D10 -F300 -V64 -Q"
  264.  
  265.       CLI > cd "Any Disk:"
  266.                            ; Cancel SR before typing next line.
  267.       CLI > ASR -r         ; remove ASR when no longer needed.
  268.  
  269. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  270.  
  271.    Workbench Usage:                                        Page A-05
  272.  
  273.       You may set the TOOL TYPES using the Workbench INFO menu choice.
  274.  
  275.       The TOOL TYPES available are:
  276.  
  277.          1) COMMAND=
  278.  
  279.             This causes the COMMAND LINE mode to take effect when filled
  280.             in. You set this to whatever COMMAND LINE string you desire,
  281.             as explained in the CLI examples, except with Workbench you
  282.             MUST specifically indicate where the command exists else no
  283.             sound will happen.
  284.  
  285.             Leaving the 'COMMAND' TOOL TYPE in a NULL condition as shown
  286.             in above without any thing after the equal sign will cause the
  287.             SPEAK DEVICE mode to be chosen. In other words; the 'COMMAND'
  288.             TOOL TYPE takes precedence over the 'SPEAK' TOOL TYPE.
  289.  
  290.             An example:  COMMAND=Run DF1:Sound/Beep -d7 -f400
  291.                          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  292.             Notice that the path indicates that "Beep" resides on
  293.             drive "DF1:" and inside a directory named "Sound".
  294.  
  295.          2) SPEAK=
  296.  
  297.             You set this to the parameters you wish the SPEAK DEVICE mode
  298.             to use when announcing texts through the 'SPEAK:' device.
  299.  
  300.             Leaving the 'SPEAK' TOOL TYPE as shown in the above line
  301.             without any thing after the equal sign will cause the
  302.             internal SPEAK parameters to be used.
  303.             The internal default SPEAK string is "opt/m/p80/s170"
  304.  
  305.             An example:  SPEAK=opt/f/p240/s200
  306.                          ~~~~~~~~~~~~~~~~~~~~~
  307.          3) SPEAK TEXT INSIDE GADGETS=
  308.  
  309.             A 'Yes' after the equal sign causes SR gadget texts to
  310.             be announced. A 'No' or NULL after the equal sign causes
  311.             gadget texts to be skipped. The default is 'No'.
  312.  
  313.             This will only take effect when SPEAK DEVICE mode is chosen.
  314.  
  315.             An example: SPEAK TEXT INSIDE GADGETS=yes
  316.                         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  317.          4) ICON IS TOGGLE=
  318.  
  319.             A 'Yes' after the equal sign will cause the ASR icon to act
  320.             as a toggle switch when chosen, meaning; if ASR was installed
  321.             then it will be removed, if ASR was not installed it will be
  322.             installed. The default is 'No'.
  323.  
  324.             A 'No' after the equal sign will cause a SR to appear whenever
  325.             the icon is accessed from Workbench.
  326.             If ASR is not installed you will see following SR gadgets:
  327.               "Install" or "Cancel"
  328.             If ASR is installed you will see the following SR gadgets:
  329.               "Remove" or "Cancel"
  330.  
  331.             An example: ICON IS TOGGLE=no
  332.                         ~~~~~~~~~~~~~~~~~
  333. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  334.  
  335.    Program Messages and Errors:                            Page A-06
  336.  
  337.       Messages possible are:
  338.  
  339.          1: "Busy with System Requests"
  340.             This means that another ASR process has a SR pending a
  341.             user's decision.
  342.  
  343.          2: "Already installed"
  344.             Option '-i' will cause this when ASR has already been
  345.             installed and is ready to work. Only one ASR process is
  346.             allowed to be installed and ready.
  347.  
  348.          3: "Already removed"
  349.             Option '-r' will cause this if the ASR process is not
  350.             installed.
  351.  
  352.          4: "Unable to remove, library vector is altered"
  353.             Options '-r' will cause this if the library pointers
  354.             associated with creating a SR are altered by another process,
  355.             and ASR will not remove itself until those library pointers
  356.             are restored to the value that were present when ASR was
  357.             installed.
  358.  
  359.          5: "Sent signal to remove code"
  360.             Option '-r' will cause this if ASR is installed and is
  361.             capable of being removed (see also note 1 & 4 above).
  362.  
  363.             NOTE 1: You will not see this message if ASR is de-activated
  364.                     from Workbench.
  365.  
  366.             NOTE 2: When the ASR process detects this signal and no
  367.                     restrictions are detected (see note 1 & 4 above)
  368.                     then it will remove itself and then it will
  369.                     SPEAK: "Removing Announce System Requests"
  370.  
  371.       Errors possible are:
  372.  
  373.          1: "Unmatched quotes"                    (seen in CLI only)
  374.          2: "Null arguments not allowed"          (seen in CLI only)
  375.          3: "Unable to allocate memory"
  376.          4: "Unable to open dos.library"          (seen in Workbench only)
  377.          5: "Unable to open intuition.library"    (seen in CLI only)
  378.          6: "Unable to open icon.library"
  379.          7: "Unable to open NIL:"
  380.          8: "Unable to open SPEAK:"
  381.          9: "Unable to execute background command >"   (seen in CLI only)
  382.             Background process failed in some manner.
  383.  
  384. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  385.  
  386.    How To Make Extra ASR PROJECT Icons:                    Page A-07
  387.  
  388.    Just for your general information, the icon for this version of
  389.    ASR is a PROJECT type icon. The first version of ASR used a TOOL
  390.    type icon.
  391.  
  392.    The following paragraphs will explain how to make and set the
  393.    TOOL TYPES of several ASR PROJECT icons. Pre-setting several project
  394.    icons this way will allow Workbench users to easily change the types
  395.    of sounds they want to hear between different computing projects,
  396.    otherwise you would have to access the Workbench INFO menu choice each
  397.    time you desired to change the sounds generated by ASR while working
  398.    from Workbench. I found that to be a pain, so I decided that setting
  399.    up several project icons with different TOOL TYPE settings would be
  400.    a better method.
  401.  
  402.    There are four pre-set PROJECT icons included with this version of ASR.
  403.  
  404.    The following steps explain how I made the ASR-Beep.info project icon
  405.    along with a dummy text file to go along with it. You may follow
  406.    these steps to make and name your own project icons:
  407.  
  408.    Step 1: Clone (copy) the "ASR.info" file to a new name. Make sure
  409.            the new name represents the type of noise or sound that ASR
  410.            will generate when activated by this new project icon.
  411.            (ie; "ASR-Beep.info" is a clone of "ASR.info").
  412.  
  413.    Step 2: Edit a dummy text file to go along with the new ".info" file.
  414.            The name of the dummy text file should be the same as the
  415.            new file but without the ".info" extension.
  416.            (ie; "ASR-Beep" is the dummy text for "ASR-Beep.info")
  417.  
  418.            The dummy text file can be empty or filled with various notes,
  419.            it does not matter what the contents are.
  420.  
  421.            NOTE: Workbench HAS to see the NAME of the dummy text file or
  422.            the information about the "ASR-Beep.info" PROJECT icon will
  423.            not get passed to ASR.
  424.  
  425.    Step 3: Choose the "ASR-Beep.info" icon from Workbench and then select
  426.            the INFO menu choice.
  427.  
  428.    Step 4: Choose the DEFAULT TOOL input line and type in the
  429.            <root/directory/name> of where the ASR program will be kept
  430.            on your system.
  431.  
  432.    Step 5: Set the TOOL TYPE parameters; read page A-06 for settings
  433.            availble.
  434.  
  435.    Step 6: Click the Save gadget of the Workbench INFO window, and put
  436.            the project icon where it is needed.
  437.  
  438. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  439.  
  440.    Operational Notes:                                      Page A-08
  441.  
  442.       The following operational notes are from the author's own
  443.       experience while using the ASR program with Workbench 1.3 version.
  444.  
  445.       1) It is rare for the ASR process to miss a remove signal, but
  446.          if it does then try again. I am not sure what causes this to
  447.          happen when it does.
  448.  
  449.       2) The following has happened a few times:
  450.          The ASR process failed to install itself and did not give any
  451.          indication of failure except that it did NOT announce its
  452.          startup.
  453.  
  454.          This happened to me while copying files to a disk drive and
  455.          trying to install ASR at the same time. I Have no idea as to
  456.          why it failed in this manner.
  457.  
  458.          If this happens to you then do an "ASR -r" and try installing
  459.          again.
  460.  
  461. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  462.  
  463.    Programmer's Notes:                                     Page A-09
  464.  
  465.    The SPEAK DEVICE mode may not announce every SR properly, it depends
  466.    upon how other program authors have set up the various parameters
  467.    needed by the ROM functions that are used in creating the SR.
  468.  
  469.    If you want to hear a surprise then make sure you set ASR to the
  470.    SPEAK DEVICE mode (ie "ASR -ig"), and then go to your System drawer
  471.    and double-click on the DiskCopy icon (for Workbench v1.3). After ASR
  472.    is done announcing the SR for DiskCopy then double-click the Format
  473.    icon and then compare the two announcements for yourself.
  474.  
  475.    It was somewhat of a surprise when I first heard the announcement
  476.    of the SR for DiskCopy. My first thought was to wonder what was wrong
  477.    with my source code, but I quickly realized that there was nothing
  478.    wrong with my code because the SR announced properly for other
  479.    programs (ie Format).
  480.  
  481.    There are various ROM routines that programmers can use in creating
  482.    the SR. One of those ROM routines is called "AutoRequest", another
  483.    routine is called "BuildSysRequest", and programs that make calls to
  484.    these functions with their "IntuiText.NextText" structures in reverse
  485.    order will cause them to be heard out of sync when announced by ASR
  486.    (as is the case with DiskCopy (Workbench 1.3)). IntuiText structures
  487.    like this WILL print in correct order within the SR window, but they
  488.    WILL NOT be announced in sequence as displayed and will sound odd.
  489.  
  490.    All that needs to be done to a program like DiskCopy is for its
  491.    author(s) to reverse the order of the "IntuiText.NextText" pointers
  492.    within the IntuiText structures, and then call the proper IntuiText
  493.    structure, and then ASR will be able to announce them in proper order.
  494.  
  495.    DiskCopy (from Workbench V1.3) is the only program that I have found
  496.    to do this.
  497.  
  498. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  499.  
  500.    Version History:                                        Page A-10
  501.  
  502.    The following information describes changes or improvements made to
  503.    each version, and they will be described in descending order;
  504.    meaning latest version information begins first:
  505.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  506.    Version 5.0 (19940301) -
  507.  
  508.    1) Changed version numbering format. Program can now be used with
  509.       the "Version" command. Date within parenthesis is shown in a
  510.       somewhat international format as (yyyymmdd).
  511.    2) Added some aesthetics to part of announcement logic.
  512.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  513.    Version 19930810 -
  514.  
  515.    1) Program has been modified to work with Workbench 1.3 and Workbench
  516.       2.05 systems, and should also work with higher Workbench versions,
  517.       but program will now work somewhat differently on Workbench
  518.       versions higher than 1.3 as explained in the following lines:
  519.  
  520.       This program may (when used on Workbench versions higher than 1.3)
  521.       only announce the presence of a System Request and will not announce
  522.       the text lines within the request nor the text within the gadgets
  523.       regardless of option settings. This operation will depend upon how
  524.       program authors design their programs.
  525.  
  526.    2) ASR will mount SPEAK: device.
  527.  
  528.       NOTE: If SPEAK device is already mounted then typing "Mount speak:"
  529.             from CLI on Workbench 2.05 version will cause the system to
  530.             lose 24 bytes each time it is typed, therefore, ASR will
  531.             appear to lose 24 bytes for each time it begins a new
  532.             announce process, but only after the ASR process has been
  533.             previously removed; I hope this note made sense to you.
  534.  
  535.    3) Removed a crashing problem that only showed up when some one would
  536.       continuously click the mousey button over the ASR icon, thereby
  537.       spawning several ASR processes somewhat simultaneously.
  538.       Why would any one do that for ?? <smile>
  539.  
  540.       [clickity clickity clicky click; clickity clickity clicky crash]
  541.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  542.    Version 19920716 -
  543.  
  544.    1) Removed a strange CLI parsing problem which appeared when the
  545.       LENGTH of the command line was at certain lengths. But, under some
  546.       CLI operating conditions the problem did not appear, and any command
  547.       line length would work. This problem, when it happens, causes the
  548.       error "Argument error" to appear whether program arguments are
  549.       legitimate or not. Any CLI line length should now work properly.
  550.  
  551.    2) ASR can be used with the "Cancel System Requests" (CSR) program.
  552.       This will allow users to hear the System Requests as they are being
  553.       automatically canceled. The CSR program must be run first before
  554.       running the ASR program.
  555.  
  556.       ie > CSR -dw   ; links CSR code in first
  557.          > ASR -ig   ; links ASR code after CSR
  558.  
  559.    3) This version of ASR will allow only one installation of its code.
  560.       Previous ASR versions would allow users to install the ASR code a
  561.       multiple of times depending upon the use of other programs.
  562.  
  563.       In example, performing the following steps while using CSR
  564.       (version 19910828) and ASR (version 19910902) would install the
  565.       ASR code each time program was invoked:
  566.  
  567.       ie > CSR i        ; 1st copy of CSR code installed in memory
  568.          > run ASR -ig  ; 1st copy of ASR code installed in memory
  569.          > CSR i        ; 2nd copy of CSR code installed in memory
  570.          > run ASR -ig  ; 2nd copy of ASR code installed in memory
  571.          > CSR i        ; 3rd copy of CSR code installed in memory
  572.          > run ASR -ig  ; 3rd copy of ASR code installed in memory
  573.  
  574.       This can no longer happen with new versions of ASR or CSR.
  575.  
  576.    4) Process will increase its own priority by 7.
  577.  
  578.    5) Program can be made resident, but the only benefit of making it
  579.       resident is to bypass loading time when program is invoked.
  580.  
  581.    6) Invoking ASR with option -i from CLI will cause ASR to completely
  582.       detach from the CLI and run as a background process.
  583.       If the background process should fail then it will attempt to
  584.       notify you of that fact with a System Request.
  585.  
  586.    7) See "Workbench usage:" item 4 for change in SR gadget operation.
  587.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  588.    Version 19910902 -
  589.  
  590.    1) Added TOOL TYPES for Workbench access.
  591.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  592.    Version 19910612 - The first version.
  593.  
  594. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  595.                        End Of User Documentation
  596.